home *** CD-ROM | disk | FTP | other *** search
/ Sunday Savers: Singing Fun! / Sunday Savers: Singing Fun!.iso / mac / Xtras / Buddy API 3.7 / Buddy API Docs.swf / texts / 1112.txt < prev    next >
Encoding:
Text File  |  2004-08-31  |  3.1 KB  |  125 lines
  1. 21
  2. --- RECORDSEPARATOR ---
  3.  
  4. --- RECORDSEPARATOR ---
  5. ReadRegString 
  6. --- RECORDSEPARATOR ---
  7. Platform:
  8. --- RECORDSEPARATOR ---
  9.  
  10. --- RECORDSEPARATOR ---
  11. Windows
  12. --- RECORDSEPARATOR ---
  13.  
  14. --- RECORDSEPARATOR ---
  15. Description:
  16. --- RECORDSEPARATOR ---
  17.  
  18. --- RECORDSEPARATOR ---
  19. baReadRegString gets a string from the Windows Registry.
  20. --- RECORDSEPARATOR ---
  21.  
  22. --- RECORDSEPARATOR ---
  23. Usage:
  24. --- RECORDSEPARATOR ---
  25.  
  26. --- RECORDSEPARATOR ---
  27. Result = ReadRegString( KeyName, ValueName, Default, Branch )
  28. --- RECORDSEPARATOR ---
  29.  
  30. --- RECORDSEPARATOR ---
  31. Arguments:
  32. --- RECORDSEPARATOR ---
  33.  
  34. --- RECORDSEPARATOR ---
  35. String, String, String, String. 
  36. --- RECORDSEPARATOR ---
  37. KeyName is the name of the key. 
  38. --- RECORDSEPARATOR ---
  39. ValueName is the name of the value. Under 16 bit, this value is ignored. 
  40. --- RECORDSEPARATOR ---
  41. Default is the string that is returned if the key/value doesn't exist. 
  42. --- RECORDSEPARATOR ---
  43. Branch is the branch of the registry to use. Can be one of the following: 
  44. --- RECORDSEPARATOR ---
  45. "HKEY_CLASSES_ROOT" 
  46. --- RECORDSEPARATOR ---
  47. "HKEY_CURRENT_USER" 
  48. --- RECORDSEPARATOR ---
  49. "HKEY_LOCAL_MACHINE" 
  50. --- RECORDSEPARATOR ---
  51. "HKEY_USERS" 
  52. --- RECORDSEPARATOR ---
  53. ΓÇ£HKEY_CURRENT_USERΓÇ¥ 
  54. --- RECORDSEPARATOR ---
  55. ΓÇ£HKEY_DYN_DATAΓÇ¥ 
  56. --- RECORDSEPARATOR ---
  57. Under 16 bit, only the HKEY_CLASSES_ROOT branch is accessible - the Branch 
  58. --- RECORDSEPARATOR ---
  59. setting is ignored.
  60. --- RECORDSEPARATOR ---
  61.  
  62. --- RECORDSEPARATOR ---
  63. Returns:
  64. --- RECORDSEPARATOR ---
  65.  
  66. --- RECORDSEPARATOR ---
  67. String. 
  68. --- RECORDSEPARATOR ---
  69. Returns the value associated with the Keyname. If the Keyname doesn't exist, then 
  70. --- RECORDSEPARATOR ---
  71. the return will be the Default string.
  72. --- RECORDSEPARATOR ---
  73.  
  74. --- RECORDSEPARATOR ---
  75. Examples:
  76. --- RECORDSEPARATOR ---
  77.  
  78. --- RECORDSEPARATOR ---
  79. Director: 
  80. --- RECORDSEPARATOR ---
  81. set Name = baReadRegString( "Courses\Computers\101", "CurrentUser", "Error", 
  82. --- RECORDSEPARATOR ---
  83. "HKEY_CLASSES_ROOT" ) 
  84. --- RECORDSEPARATOR ---
  85. Authorware: 
  86. --- RECORDSEPARATOR ---
  87. Name := baReadRegString( "Courses\\Computers\\101", "CurrentUser", "Error", 
  88. --- RECORDSEPARATOR ---
  89. "HKEY_CLASSES_ROOT" )
  90. --- RECORDSEPARATOR ---
  91.  
  92. --- RECORDSEPARATOR ---
  93. Notes:
  94. --- RECORDSEPARATOR ---
  95.  
  96. --- RECORDSEPARATOR ---
  97. A Registry entry consists of keys and sub-keys, similar to the directories and sub- 
  98. --- RECORDSEPARATOR ---
  99. directories in the Windows file system. 32 bit Windows adds Values to the registry. 
  100. --- RECORDSEPARATOR ---
  101. These can be thought of as files within the key. These Values are not available 
  102. --- RECORDSEPARATOR ---
  103. under 16 bit - the ValueName argument is ignored. 
  104. --- RECORDSEPARATOR ---
  105. Also in 16 bit, this function can only obtain values from keys located in the 
  106. --- RECORDSEPARATOR ---
  107. HKEY_CLASSES_ROOT branch of the Registry. 
  108. --- RECORDSEPARATOR ---
  109. Under Windows 3.1, the KeyName can not contain any spaces. 
  110. --- RECORDSEPARATOR ---
  111. This function returns a maximum of 2000 characters.
  112. --- RECORDSEPARATOR ---
  113.  
  114. --- RECORDSEPARATOR ---
  115. See also:
  116. --- RECORDSEPARATOR ---
  117.  
  118. --- RECORDSEPARATOR ---
  119. baWriteRegString 
  120. --- RECORDSEPARATOR ---
  121. baReadRegNumber 
  122. --- RECORDSEPARATOR ---
  123. baWriteRegNumber 
  124. --- RECORDSEPARATOR ---
  125. baDeleteReg